<html>
    <head>
        <title>监听权限申请</title>
    </head>
    <body>
        <script>
            /*
                一、监听权限申请

                         app-android平台，可使用本API监听应用权限申请确认框的弹出和关闭.

                         不管是哪处的业务代码在申请权限，当弹出和关闭权限申请确认框时均会触发本监听事件。

                         华为应用市场审核时要求：APP在调用终端权限时，应同步告知用户申请该权限的目的。此时即可使用本API，在app.uvue里全局监听。

                         创建监听对象后，返回RequestPermissionListener，然后调起其的onConfirm和onComplete。

                                ①、当权限申请的确认框在手机端弹出时，会触发onConfirm，回调中会以数组方式提供权限名称列表。

                                ②、当权限申请的确认框被用户关闭后，会触发onComplete
                                
            */

            /*
                二、uni.createRequestPermissionListener()

                                1、概述

                                        创建一个监听权限申请的 RequestPermissionListener 对象

                                2、平台差异说明

                                            HBuilderX (4.0+) android 平台支持  
                                            
                                            元服务
                                            x

                                3、createRequestPermissionListener 兼容性
                                            HarmonyOS
                                            x

                                         ★、注意：HBuilderX 4.01 Vue2项目需要使用自定义基座测试监听权限申请的功能，标准基座暂不支持测试。

                                4、RequestPermissionListener 对象的方法列表

                                                    方法	        参数	    说明

                                                ①、onRequest	callback	监听申请系统权限

                                                ②、onConfirm	callback	监听弹出系统权限授权框

                                                ③、onComplete	callback	监听权限申请完成
                                                
                                                ④、stop		                取消所有监听

                                5、代码示例：

                                            https://uniapp.dcloud.net.cn/api/system/create-request-permission-listener.html#createrequestpermissionlistener-%E5%85%BC%E5%AE%B9%E6%80%A7
            */

            /*
                 三、全局监听权限申请并弹窗提示用户权限申请原因

                                iOS的权限申请原因，是在manifest或info.plist里配置的。

                                Android没有在系统层面提供这套机制，但一些应用商店（如华为），又要求申请权限时弹框说明原因。

                                虽然uni.createRequestPermissionListener可以监听权限申请，但前端弹框的层级较低，无法正常显示权限申请原因。

                                所以DCloud提供了一个插件，可以在原生层面给出文字提示：

                                    全局监听权限申请可参考插件uni-registerRequestPermissionTips ： https://ext.dcloud.net.cn/plugin?name=uni-registerRequestPermissionTips
            */

            /*
                四、注意：

                            ①、如果权限已经申请并且允许之后，onConfirm不会触发。

                            ②、如果同时申请多个权限时，onComplete可能会触发多次。

                            ③、权限列表参考：https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#permissions
            */
        </script>
    </body>
</html>